Belgian Amiga Club - ADF Collection/BS1 part 60.zip/BS1 part 60/Imagemaster d4.adf/apa.lzh/hlp_arexx10

Text File | 1993-08-30 | 17KB | 757 lines

\ApAssist
\: - This is the Quick Help for the ARexx in IM R/t -
\: ----------------------------------------------------------
\:   Written by David E. Patterson
\: ----------------------------------------------------------

\font topaz.font 8
\tc 1
\wr
\lj
\dd "imh_descriptor"

\index "hlp_arexx2/padcanvas-relief"
\toc "hlp_toc/toc"
\help "aa_help/help

\node "punch"
\title "Punch"
\next "rect"
\prev ""
\{ \tc 15 Punch \} - Punches the secondary buffer into the primary buffer.

\nw
Usage - '\{ \tc 15 punch <contrast>\} '

\{ \ts bu Sample Script\} :

'area';
'punch';

See Also: \{ \tc 15 \ts b \link " emboss " "hlp_arexx7/emboss"\}

* User Interface: \{ \tc 11   Compose Panel
                        Special Compositions
                            Punch\}

\endnode

\node "rect"
\title "Retangular Mask"
\next "rectarea"
\prev "punch"
\{ \tc 15 Rect \} - Defines a retangular mask.

\nw
Usage - '\{ \tc 15 rect <Xleft> <Ytop> <Xright> <Ybottom>\} '

\{ \ts bu Sample Script\} :

'\{ \tc 15 rect 10 10 630 380\} ';
'contrast 80';

\endnode

\node "rectarea"
\title "Rectangular Area"
\next "redadj"
\prev "rect"
\{ \tc 15 Rectarea \} -  Allows user to select a rectangular area.

\nw
Usage - '\{ \tc 15 rectarea\} '

\{ \ts bu Sample Script\} :

'\{ \tc 15 rectarea\} ';
'contrast';

\endnode

\node "redadj"
\title "Red Adjust"
\next "redcont"
\prev "rectarea"
\{ \tc 15 Redadj \} - Changes the red brightness for selected area.

\nw
Usage - '\{ \tc 15 redadj <amount>\} '

\{ \tc 15 Amount: 0 - 100 \}

\{ \ts bu Sample Script\} :

'area';
'\{ \tc 15 redadj 89\} ';

See Also: \{ \tc 15 \ts b \link "blueadj " "hlp_arexx5/blueadj"
          \link "greenadj" "hlp_arexx7/greenadj"\}


* User Interface: \{ \tc 11    Process Panel
                          R,G,B Corrections
                              Red\}

\endnode

\node "redcont"
\title "Red Contrast"
\next "redraw"
\prev "redadj"
\{ \tc 15 Redcont \} - Changes the red contrast for a selected area.

\nw
Usage - '\{ \tc 15 redcont <amount>\} '

\{ \tc 15 Amount: 0 - 100\}

\{ \ts bu Sample Script\} :

'area';
'\{ \tc 15 redcont 89\} ';

See Also: \{ \ts b \tc 15 \link "bluecont " "hlp_arexx5/bluecont"
          \link "greencont" "hlp_arexx7/greencont"\}


* User Interface: \{ \tc 11  Process Panel
                        R,G,B Corrections
                            Red Cont.\}

\endnode

\node "redraw"
\title "Re-Draw"
\next "relief"
\prev "redcont"
\{ \tc 15 Redraw \} - Redraws the image using the current display settings.

\nw
Usage - '\{ \tc 15 redraw\} '   (fcredraw for FireCracker)

\{ \ts bu Sample Script\} : (Fragment)

options results;
'jackin';
jackptr = result;
options;
'backuptoundo';
address command;
'cmpi:myfile '||jackptr;
address(prtnme);
'\{ \tc 15 redraw\} ';

* User Interface: \{ \tc 11    Key board \{ \ts b R \} Key\}

\endnode

\node "relief"
\title "Relief"
\next "remove"
\prev "redraw"
\{ \tc 15 Relief \} - Creates a relief (embossed) representation of the
image.

\nw
Usage - '\{ \tc 15 relief <amount>\} '

\{ \tc 15 Amount: 0 - 100\}

\{ \ts bu Sample Script\} :

'area';
'\{ \tc 15 relief 89\} ';

* User Interface: \{ \tc 11   Process Panel
                        Special Effects
                            Relief\}

\endnode

\node "remove"
\title "Remove"
\next "rename"
\prev "relief"
\{ \tc 15 Remove \} - Removes features from a selected region.

\nw
Usage - '\{ \tc 15 remove <direction>\} '

\{ \tc 15 Direction: 1 = horizontal, 2 = vertical, 3 = radial \}

\{ \ts bu Sample Script\} :

'area';
'\{ \tc 15 remove 1\} ';

* User Interface: \{ \tc 11  Process Panel
                        Filters
                           Remove Feature\}

\endnode

\node "rename"
\title "Re Name"
\next "renderdefs"
\prev "remove"
\{ \tc 15 Rename \} - Renames any available buffer.

\nw
Usage - '\{ \tc 15 rename <#> <newname>\} '

\{ \ts bu Sample Script\} :

'\{ \tc 15 rename 2 CoolBuff\} ';

\endnode

\node "renderdefs"
\title "Render Definitions"
\next "renderext"
\prev "rename"
\{ \tc 15 Renderdefs \} - Returns a string that describes render file path
and extension.

\nw
Usage - '\{ \tc 15 renderdefs\} '

\{ \ts bu Sample Script\} :

options results;
'\{ \tc 15 renderdefs\} ';
info = result;
parse var info path ','extension;
options;

See also:  \{ \tc 15 \ts b \link "blenddefs  " "hlp_arexx5/blenddefs"
           \link "imagedefs  " "hlp_arexx7/imagedefs"
           \link "macrodefs  " "hlp_arexx8/macrodefs"
           \link "palettedefs" "hlp_arexx9/palettedefs"\}

\endnode

\node "renderext"
\title "Render Extension"
\next "renderpath"
\prev "renderdefs"
\{ \tc 15 Renderext \} - Sets a new extension for saving rendered images.

\nw
Usage - '\{ \tc 15 renderext <newextension>\} '

\{ \ts bu Sample Script\} :

options results;
'askstring "New Extension:" "rnd"'name;
name = result;
options;
'\{ \tc 15 renderext\} ' name;

See Also: \{ \tc 15 \ts b \link "blendext  " "hlp_arexx5/blendext"
          \link "imgageext " "hlp_arexx7/imageext"
          \link "macroext  " "hlp_arexx8/macroext"
          \link "paletteext" "hlp_arexx9/paletteext"\}

* User Interface: \{ \tc 11  Setup Panel
                       Render Ext\}

\endnode

\node "renderpath"
\title "Render Path"
\next "ric"
\prev "renderext"
\{ \tc 15 Renderpath \} - Sets a new path for saving rendered images.

\nw
Usage - '\{ \tc 15 renderpath <newpath>\} '

\{ \ts bu Sample Script\} :

options results;
'askstring "New_Path" "Work:renders"'name;
path = result;
options;
'\{ \tc 15 renderpath\} ' path;

See Also: \{ \tc 15 \ts b \link "blendpath  " "hlp_arexx5/blendpath"
          \link "imgagepath " "hlp_arexx7/imagepath"
          \link "macropath  " "hlp_arexx8/macropath"
          \link "palettepath" "hlp_arexx9/palettepath"\}

\endnode

\node "ric"
\title "Remove Isolated Chunks"
\next "rip"
\prev "renderpath"
\{ \tc 15 Ric \} - Removes isolated chunks from a selected region.

\nw
Usage - '\{ \tc 15 ric <Effect> <chunksize>\} '

\{ \tc 15 Effect:     1 to 100
Chuncksize: 0 to 40\}

\{ \ts bu Sample Script\} :

'area';
'\{ \tc 15 ric 50 10\} ';

* User Interface: \{ \tc 11
                        Filters
                           Remove Chunk\}

\endnode

\node "rip"
\title "Remove Isolated Pixels"
\next "ripple"
\prev "ric"
\{ \tc 15 Rip \} - Removes isolated pixels from a selected region.

\nw
Usage - '\{ \tc 15 rip <effect>\} '
        '\{ \tc 15 rip <effect> <chunksize>\} '

\{ \ts bu Sample Script\} :

'area';
'\{ \tc 15 rip 40 3\} ';

* User Interface: \{ \tc 11
                        Filters
                           Remove Pixel\}

\endnode

\node "ripple"
\title "Ripple"
\next "ris"
\prev "rip"
\{ \tc 15 Ripple \} - Generates an effect similar to dropping a stone in a
pond.

\nw
Usage - '\{ \tc 15 ripple <wavelength> <magnitude> <phase>\} '

\{ \tc 15 Wave length:    In pixels
Magnitude:      0 to 100
Phase:          0 to 360 degrees\}

\{ \ts bu Sample Script\} :

'area';
'\{ \tc 15 ripple 80 30 200\} ';

* User Interface: \{ \tc 11
                        Geometric Transformations
                             Radial Wave\}

\endnode

\node "ris"
\title "Remove Isolated Streaks"
\next "rollimage"
\prev "ripple"
\{ \tc 15 Ris \} - Removes isolated streaks from a selected region.

\nw
Usage - '\{ \tc 15 ris <horizontal> <vertical>\} '

\{ \tc 15 Horizontal: 1 - 100%
Vertical:   1 - 100%\}

\{ \ts bu Sample Script\} :

'area';
'\{ \tc 15 ris 50 50\} ';

* User Interface: \{ \tc 11
                        Filters
                            Remove Streak\}

\endnode

\node "rollimage"
\title "Roll Image"
\next "rotate"
\prev "ris"
\{ \tc 15 Rollimage \} - Rolls image horizontally and/or vertically.

Rolls an image horizontally, vertically or in both directions.  In \{ \ts b
wrap mode \}  the image that rolls off the edge will appear on the opposite
edge. \{ \ts b Edge Fill \} discards pixels that are rolled off the edge, the
incoming edge is filled with a duplicate of the receeding edge of the image.
\{ \ts b Pad with Color \} discards pixels that are rolled off the edge and
fills the incoming edge with a solid color, set in the process panel's \{ \tc
10 \ts i Set forground color\} .

\nw
Usage - '\{ \tc 15 rollimage <Roll_X> <Roll_Y> <Mode>\} '

\{ \tc 15 Roll_X:   Negative X - moves image left  Possitive X - moves image right
Roll_Y:   Negative Y - moves image up    Possitive Y - moves image left
Mode:     0 = Wrap, 1 = Edge Fill, 2 = Color Fill \}

\{ \ts bu Sample Script\} :

'area';
'\{ \tc 15 rollimage\} ' 10 10 0;

* User Interface: \{ \tc 11   Process Panel
                        Geometric Transformations
                            Roll Image\}

\endnode

\node "rotate"
\title "Rotate"
\next "rot90"
\prev "rollimage"
\{ \tc 15 Rotate \} - Creates a new buffer from a selected region and rotates
it.

\nw
Usage - '\{ \tc 15 Rotate <rotangle> <aspect> [newname]\} '

\{ \tc 15 Rotangle:  0 to 360 degrees
Aspect:    Aspect Ratio
Newname:   Optional name for new buffer\}

\{ \ts bu Sample Script\} :

'area';
'\{ \tc 15 rotate 45 72\} ';

* User Interface: \{ \tc 11   Process Panel
                        Geometric Transformation
                            Rotate Clip\}

\endnode

\node "rot90"
\title "Rotate 90 Degrees"
\next "rtile"
\prev "rotate"
\{ \tc 15 Rot90 \} - Creates a new buffer from a selected region.

New buffer created from selected region is rotated in multiples of 90 degrees
from the original.

\nw
Usage - '\{ \tc 15 rot90 <step>\} '

\{ \tc 15 Step:   1 = 90 degrees counter-clockwise
        2 = 90 degrees clockwise
        3 = 180 degrees\}

\{ \ts bu Sample Script\} :

'area';
'\{ \tc 15 rot90 2\} ';

See Also: \{ \tc 15 \ts b \link "rotate" "hlp_arexx10/rotate"\}

\endnode

\node "rtile"
\title "Random Tiling"
\next "rubthru"
\prev "rot90"
\{ \tc 15 Rtile \} - Causes random tiling to occur in the selected region.

\nw
Usage - '\{ \tc 15 rtile <tile_length>\} '

\{ \tc 15 Tile length: length of tiles in pixels \}

\{ \ts bu Sample Script\} :

'area';
options results;
'askprop length: 100 0 200';
length = result;
options;
'\{ \tc 15 rtile\} ' length;

* User Interface: \{ \tc 11   Process Panel
                        Special Effects
                            Random Tile\}

\endnode

\node "rubthru"
\title "Rub Through / Rubthru"
\next "sat"
\prev "rtile"
\{ \tc 15 Rubthrough \} - Rubs the secondary buffer through into the primary
buffer.

Inserts the section of the secondary buffer that corresponds with the
selected region of the primary buffer, as if the secondary buffer and the
primary buffer are the same size.

\nw
Usage - '\{ \tc 15 rubthru\} '

\{ \ts bu Sample Script\} :

'area';
'\{ \tc 15 rubthru\} ';

* User Interface: \{ \tc 11   Compose Panel
                        Linear Compositions
                            Rub-Thru\}

\endnode

\node "sat"
\title "Saturation"
\next "save"
\prev "rubthru"

\{ \tc 15 Sat \} - Changes the saturation of an area.

Changes the saturation of each pixel without changing the hue.

\nw
Usage - '\{ \tc 15 sat <effect>\} '

\{ \tc 15 Effect: 0 to 100;\}

\{ \ts bu Sample Script\} :

'area';
'\{ \tc 15 sat 50\} ';

* User Interface: \{ \tc 11   Process Panel
                        Standard Adjustments
                            Saturation\}

\endnode

\node "save"
\title "Save"
\next "saveimask"
\prev "sat"
\{ \tc 15 Save \} - Saves the selected image buffer.

\nw
Usage - '\{ \tc 15 save <buffer #>\} '

\{ \ts bu Sample Script\} :

'\{ \tc 15 save 4\} ';

\endnode

\node "saveimask"
\title "Save Image Mask"
\next "savemask"
\prev "save"
\{ \tc 15 Saveimask \} - Saves the image mask (the valid image area mask).

\nw
Usage - '\{ \tc 15 saveimask <complete_filename>\} ';

\{ \ts bu Sample Script\} :

'\{ \tc 15 saveimask work:masks/mymask.msk\} ';

* User Interface: \{ \tc 11   File I/O
                        Save Image Mask\}

\endnode

\node "savemask"
\title "Save Mask"
\next "savepal"
\prev "saveimask"
\{ \tc 15 Savemask \} - Saves the main mask (the region selection mask).

\nw
Usage - '\{ \tc 15 savemask <complete_filename>\} ';

\{ \ts bu Sample Script\} :

'area';
'contrast 50';
'\{ \tc 15 savemask main:images/masks/areamask.msk\} ';

* User Interface: \{ \tc 11   File I/O
                       Save Image Mask\}

\endnode

\node "savepal"
\title "Save Palette"
\next "savepal64"
\prev "savemask"
\{ \tc 15 Savepal \} - Saves the palette of the last 256 color render.

\nw
Usage -   '\{ \tc 15 savepal name\} '

\{ \ts bu Sample Script\} :

'savepal name';

* User Interface: \{ \tc 11   Paint Panel
                        Adjust Palette
                             Sav\}

\endnode


\node "savepal64"
\title "Save 64 color palette"
\next "sbuffers"
\prev "savepal"
\{ \tc 15 Savepal64 \} - Saves the palette that was generated by the last 64
color render.

\nw
Usage - '\{ \tc 15 savepal64 <filename>\} ';

\{ \ts bu Sample Script\} :

'\{ \tc 15 savepal64 pal64\} ';

\endnode

\node "sbuffers"
\title Sbuffers
\next "secondary"
\prev "savepal64"
\{ \tc 15 Sbuffers \} - Returns all buffers execpt the primary buffer and
secondary buffer.
\nw

Usage - '\{ \tc 15 sbuffers\} '

\{ \ts bu Sample Script\} :

options results;
'\{ \tc 15 sbuffers\} ';
buffs = result;
options;
parse var buffs buffname','buffnumber;

See Also: \{ \tc 15 \ts b \link "buffers  " "hlp_arexx5/buffers"
          \link "current  " "hlp_arexx6/current"
          \link "obuffers " "hlp_arexx9/obuffers"
          \link "secondary" "hlp_arexx10/secondary"\}

\endnode

\node "secondary"
\title Secondary
\next "setblend"
\prev "sbuffers"
\{ \tc 15 Secondary Buffer \} - Returns information about the secondary
buffer.

Returns a string with the following information about the secondary buffer:
Buffer Name, Buffer Number, X Dim, Y Dim, X Dim * Y Dim, Memory Used, Parent
name, and the Parent Number.

\nw
Usage -  '\{ \tc 15 secondary\} ';

\{ \ts bu Sample Script\} :

options results;
'\{ \tc 15 secondary\} ';
info = result;
options;
parse var info bname','bnumber','xdim','ydim','xdimydim','memused','
               parentname','parentnumber;
'newbuff' xdim ydim;

\endnode

\node "setblend"
\title "Setblend"
\next "setmulti"
\prev "secondary"
\{ \tc 15 Setblend \} - Sets the blend transparency curves.

\nw
Usage - '\{ \tc 15 setblend <direction> <position> <value>\} '

\{ \tc 15 Direction:  1 = Up, 2 = right, 3 = down, 4 = left
Position:   0 to 255
Value:      0 (fully transparent) to 255 (opaque)\}

\{ \ts bu Sample Script\} :

'entire';
options results;
'askprop Position: 50 0 255'
position = result;
'askprop Blend: 0 0 255';
blend = result;
'options';
'\{ \tc 15 setblend 1\} ' position blend;
'merge';


* User Interface: \{ \tc 11  Process Panel
                        Set Blend\}

\endnode

\node "setmulti"
\title "Set Multi"
\next "setpalette"
\prev "setblend"
\{ \tc 15 Setmulti \} - Sets all colors for the gradient fill function.

\nw
Usage - 'setmulti <middlered> <middlegreen> <middleblue>
                  <leftred>   <leftgreen>   <leftblue>
                  <leftred>   <rightgreen>  <rightblue>
                  <topred>    <topgreen>    <topblue>
                  <lowerred>  <lowergreen>  <lowerblue>'

\{ \ts bu Sample Script\} :

'\{ \tc 15 setmulti 10 20 30 180 150 160 70 80 90 100 110 120 130 140 150\} ';
'area';
'multifill 6';

* User Interface: \{ \tc 11   Process Panel
                         Set Gradient\}

\endnode

\node "setpalette"
\title "Set Palette"
\next ""
\prev "setmulti"
\{ \tc 15 Setpalette \} - Sets an individual palette color.

\{ \tc 15 Setpalette \} makes it possible to set the 256 palette colors
individually.

\nw
Usage -     '\{ \tc 15 setpalette <entry#> <red> <green> <blue>\} ';

\{ \tc 15 Entry:  0 to 255  palette entry number
Red:    0 to 255
Green:  0 to 255
Blue:   0 to 255 \}

\{ \ts bu Sample Script\} :

do i=0 to 255
  '\{ \tc 15 setpalette' i 255-i 255-i 255-i\} ;
   end;

* User Interface: \{ \tc 11   Paint Panel
                        Adjust Palette\}

\endnode